home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d10 / mailfile.arc / MAILFILE.DOC < prev    next >
Text File  |  1991-03-20  |  5KB  |  120 lines
  1.  Mail File  -  Four small doors to emulate sending files to a users mailbox.
  2. ------------------------------------------------------------------------------
  3. v1.0  91 03 13  by Roy Pereira
  4.  
  5. SEND   
  6.   PCB syntax: SEND file [file[file...]] TO user
  7.               file is any filename (XXXXXXXX.XXX)
  8.               user is any user's name (JOHN SMITH)
  9.   DOS syntax: SEND pcboard.dat databasefile
  10.               pcboard.dat is the location and name of your pcboard.dat file
  11.               databasefile is the location and name of your data file
  12.   DOS errorlevels:
  13.                    0 - OK
  14.                    1 - Could not open PCBOARD.SYS
  15.                    2 - Not enough arguments
  16.                    4 - Could no find the PCBDOOR environment variable
  17.                    5 - User was not found in PCBNDX.x file
  18.  
  19.   This command saves the current date, the user who is sending the file, the 
  20. user who is receiving the file, and the filename to the database file.  Then it
  21. issues the keyboard macros "UB file".
  22.  
  23.  
  24. FILELIST
  25.   PCB syntax: FILELIST
  26.   DOS syntax: FILELIST databasefile
  27.               databasefile is the location and name of your data file
  28.   DOS errorlevels:
  29.                   0 - OK
  30.                   1 - Could not open PCBOARD.SYS
  31.                   2 - Not enough arguments
  32.  
  33.   This command prints out all of your files from the data file to PCBDOOR.TXT,
  34. so it will be viewed upon returning from the door.
  35.  
  36.  
  37. NEWFILES
  38.    PCB syntax: NEWFILES
  39.    DOS syntax: NEWFILES databasefile
  40.                databasefile is the location and name of your data file
  41.                NOTE: You must have a user.sys in the current directory
  42.    DOS errorlevels:
  43.                    0 - OK
  44.                    1 - Could not open PCBOARD.SYS
  45.                    2 - Not enough arguments
  46.                    3 - Could not open USER.SYS
  47.  
  48.   This command prints out all of your new files (ie. files that have been sent
  49. to you since you last logged on) from the data file to PCBDOOR.TXT.
  50.  
  51.  
  52. RECEIVE
  53.    PCB syntax: RECEIVE file
  54.                file is any filename
  55.    DOS syntax: RECEIVE databasefile
  56.                databasefile is the location and name of your data file
  57.    DOS errorlevels:
  58.                    0 - OK
  59.                    1 - Could not open PCBOARD.SYS
  60.                    2 - Not enough arguments
  61.                    4 - Specified file was not found or the user had no right to
  62.                        receive the entry
  63.  
  64.   This command joins the appropriate conference and issues the 'D file" command.
  65.  
  66.  
  67. KILLFILE
  68.    PCB syntax: KILLFILE file
  69.                file is any filename
  70.    DOS syntax: KILLFILE databasefile
  71.                databasefile is the location and name of your data file
  72.    DOS errorlevels:
  73.                    0 - OK
  74.                    1 - Could not open PCBOARD.SYS
  75.                    2 - Not enough arguments
  76.                    3 - Could not find the PCBDOOR environment variable
  77.                    4 - Specified file was not found or the user had no right to
  78.                        delete the entry
  79.  
  80.   This command deletes an entry in your data file that corresponds to the
  81. filename given if the user is either the person who uploaded it or the person
  82. the file is intended for.  It produces a file that the last character of the
  83. extension or filename is '@'.  
  84.                   eg.  FILE.DAT -> FILE.DA@
  85.                        DATAFILE -> DATAFIL@
  86.  
  87. -----------------------------------------------------------------------------
  88. You must use these doors with v14.5a (beta) and later.  Each command looks for
  89. an enviroment variable called PCBDOOR, and send output to either PCBOARD.KBD 
  90. and/or PCBDOOR.TXT.
  91.  
  92. All the programs are set up to work with any language, since you can set the
  93. approriate responces to errorlevels.
  94.  
  95. All uploaded files are still public, these commands just emulate a mailbox that
  96. can handle files.  I've heard this feature is coming in v15.0 PCBoard.
  97.  
  98. The following is the structure of the database file in C:
  99.          struct flatfile
  100.          {
  101.            char from[25];
  102.            char to[25];
  103.            char fileName[12];
  104.            struct date dateUploaded;
  105.            unsigned conferenceNo;
  106.            char conferenceName[14];
  107.          };
  108. The struct date is from the dos.h include file.
  109.  
  110. -----------------------------------------------------------------------------
  111. Any questions/comments can be refered to:
  112.  
  113.   Roy Pereira
  114.   369 Enfield Avenue
  115.   Ottawa, Ontario, Canada
  116.   K1L 7L2
  117.  
  118.   C.I.D.A. bulletin board (819)953-8207/8208
  119.  
  120.